home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 013 / cweep214.arc / CWEEP.DOC < prev   
Encoding:
Text File  |  1985-07-27  |  16.3 KB  |  381 lines
  1. .OP
  2. .PO0
  3.                     CWEEP - A SWEEP-like program for MS-DOS
  4.  
  5.  
  6.                                 By Gary M. Berg
  7.                               5850 Duncraig Drive
  8.                                  Apartment 806
  9.                               Dayton, Ohio   45426
  10.      
  11.                               C.I.S. # 70106,1624
  12.      
  13.             Copyright (C) 1984, 1985 by Gary M. Berg/Chemineer Inc.
  14.      
  15.      
  16.                                    Disclaimer
  17.      
  18.         This software has been released to the public domain by the author.
  19.      All commercial rights are retained by the author.  It may be freely
  20.      passed on to others as long as no charge is made except for possibly a
  21.      small copying charge.  Although this software is thought to work as
  22.      described, no warranty of fitness is made for this software.
  23.      
  24.      
  25.      
  26.         CWEEP is a program to provide the same capabilities for the MS-DOS
  27.      user as the program SWEEP does for the CP/M user.  It provides the
  28.      ability to take a sorted list of the files on a disk and move forward
  29.      and backward in the list.  Files can be viewed, copied, deleted
  30.      individually and in groups.
  31.      
  32.         CWEEP is invoked at the MS-DOS command line by:
  33.      
  34.                     CWEEP {d:}{path}{afn} {-sw} {-sw}
  35.      
  36.           {d:}      an optional drive letter, the default being the
  37.                     currently logged drive
  38.      
  39.           {path}    an optional path.  Valid only for the 2.x version.
  40.      
  41.           {afn}     an optional ambiguous filename of what files to look
  42.                     at, the default begin "*.*" (in the currently logged
  43.                     directory under DOS 2.x).
  44.      
  45.           {-sw}     an optional switch or switches.  Switches begin with a
  46.                     '-' character.
  47.      
  48.         CWEEP will then look up all files matching the specified files, and
  49.      prompt with the first file name.  At this point, commands can be
  50.      entered to move around in the list, tag files, copy files, etc.  The
  51.      display on the next page was generated by starting CWEEP with no
  52.      filename specified:
  53.  
  54.  
  55.  
  56.                                      Page 1
  57. .PAè                    CWEEP - A SWEEP-like program for MS-DOS
  58.  
  59.  
  60.           CWEEP                    (Display for version 1.x)
  61.      
  62.                                  CWEEP version 1.37
  63.                  Copyright (C) 1985 by: Gary M. Berg/Chemineer Inc.
  64.      
  65.               sp/cr Advance to next file      [M]  Mass copy tagged files
  66.                [A]  Re-tag '#' marked files   [N]  Calculate CRC
  67.                [B]  Back up one file          [P]  Protected mass copy
  68.                [C]  Copy file to drive        [R]  Rename a file
  69.                [D]  Delete a file             [S]  Sort directory
  70.                [E]  Erase (un)tagged files    [T]  Tag a file
  71.                [F]  Free space on a drive     [U]  Untag a file
  72.                [H]  Hexidecimal display       [V]  View file
  73.                [I]  Print size/time for file  [W]  Wildcard file tag
  74.                [J]  Jump to a named entry     [X]  Exit program
  75.                [L]  Log new drive/filename    [Z]  Change subdirectory
  76.              [?],[/]Print this message        [=]  Goto settings menu
  77.      
  78.              [-?], [+?] List other help messages, [@] for printer
  79.      
  80.              47 files, using 226089 bytes (245K)  -- 19968 bytes free (20K)
  81.      
  82.        1. I:CW-COPY .C   08-Feb-1985     7K :[X] eXit
  83.      
  84.      
  85.      or
  86.      
  87.           CWEEP                    (Display for 2.x version)
  88.      
  89.                                  CWEEP version 2.14
  90.                  Copyright (C) 1985 by: Gary M. Berg/Chemineer Inc.
  91.      
  92.               sp/cr Advance to next file      [M]  Mass copy tagged files
  93.                [A]  Re-tag '#' marked files   [N]  Calculate CRC
  94.                [B]  Back up one file          [P]  Protected mass copy
  95.                [C]  Copy file to drive        [R]  Rename a file
  96.                [D]  Delete a file             [S]  Sort directory
  97.                [E]  Erase (un)tagged files    [T]  Tag a file
  98.                [F]  Free space on a drive     [U]  Untag a file
  99.                [H]  Hexidecimal display       [V]  View file
  100.                [I]  Print size/time for file  [W]  Wildcard file tag
  101.                [J]  Jump to a named entry     [X]  Exit program
  102.                [L]  Log new drive/filename    [Z]  Change subdirectory
  103.              [?],[/]Print this message        [=]  Goto settings menu
  104.      
  105.              [-?], [+?] List other help messages, [@] for printer
  106.      
  107.              48 files, using 227027 bytes (246K)  -- 18944 bytes free (19K)
  108.      
  109.        1. I:CW-COPY .C   08-Feb-1985     7K :[X] eXit
  110.                                      Page 2
  111. .PAè                    CWEEP - A SWEEP-like program for MS-DOS
  112.  
  113.  
  114.         The files matching what was specified (in this case *.*) are sorted
  115.      in alphabetic order, and the first file in the list is listed on the
  116.      screen with the date and the size rounded up to the nearest 1K.  In
  117.      addition, the amount of space free and the amount of space used in the
  118.      selected files is displayed.
  119.      
  120.         The following is a list of commands with a short explanation:
  121.      
  122.           [@]       This character may be prefixed to a command to cause
  123.                     the output of the command to also go to the printer.
  124.                     This works with the [?] help, [H]ex, [N] CRC, [Q]uery,
  125.                     and [V]iew commands.  If the command is a "paged"
  126.                     display, form-feeds will automatically be added to the
  127.                     printer output every 60 lines.
  128.      
  129.           <sp>
  130.           <cr>      Advance to the next file on the list.  Go to the first
  131.                     file on the list if you are at the last file on the
  132.                     list.
  133.      
  134.           [A]       Re-tag all files which are marked with a "#" in the
  135.                     list.
  136.      
  137.           <bs>
  138.           [B]       Back up to the previous file in the list.  Go to the
  139.                     last file in the list if B is entered when you are
  140.                     waiting at the first file on the list.
  141.      
  142.           [C]       Copy this file to another drive.  Prompt for the drive
  143.                     to copy to.  Destination drive can be entered in the
  144.                     form "d[:[v]]".  The if the "v" is specified, then the
  145.                     copy will be verified.  If the file already exists, the
  146.                     user will be queried about whether to delete it or not.
  147.                     In version 2.x, the destination may be given as a
  148.                     subdirectory.  The default drive will be the current
  149.                     one.
  150.      
  151.                     "A"               - Copy to drive A
  152.                     "A:"              - Copy to drive A
  153.                     "B:V"             - Copy to drive B, and verify copy
  154.                     "B:\GARY:V"       - Copy to subdirectory "\GARY" on
  155.                                         drive B.  Verify the copy.
  156.                     "OTHER\SOME:V"    - Copy to subdirectory "OTHER\SOME"
  157.                                         on the logged drive.  Note that
  158.                                         this is a relative subdirectory,
  159.                                         relative to the current sub-
  160.                                         directory on the logged drive.
  161.  
  162.  
  163.  
  164.                                      Page 3
  165. .PAè                    CWEEP - A SWEEP-like program for MS-DOS
  166.  
  167.           [-C]      Copy file to another file name.  Need to specify what
  168.                     the new drive and file name are.  Append a ":V" to the
  169.                     end of the new name if you want the copy verified.
  170.                     Specify the destination subdirectory if required with
  171.                     version 2.x.
  172.      
  173.           [D]       Delete file.  You are asked to verify deletion.
  174.      
  175.           [E]       Erase all tagged or untagged files.  User is prompted
  176.                     for which type of files to erase, and whether the user
  177.                     should be prompted about each file or not.  At most
  178.                     options an "A" will abort the operation.
  179.      
  180.           [F]       Check free space on any drive.
  181.      
  182.           [H]       Dump the file in hex format.  The escape and return
  183.                     keys abort the dump, any other key pauses it.
  184.      
  185.           [-H]      Dump the file in hex one 'page' at a time.
  186.      
  187.           [I]       Display the file size in bytes and the creation time.
  188.      
  189.           [J]       Jump to the file in the list.  Specify name and
  190.                     extension, it will jump to the closest point in the
  191.                     list.
  192.      
  193.           [L]       Log in a new drive (directory on V2.x) and ambiguous
  194.                     filename.  Will replace the list currently being used
  195.                     by one matching what was entered.  If no period (".")
  196.                     is in the string, a "*.*" will be appended to the
  197.                     string for the ambiguous filename.
  198.      
  199.           [M]       Copy all files which have been tagged to a specified
  200.                     drive.  The syntax is the same as for the Copy option.
  201.                     This option WILL delete (without warning) any files
  202.                     existing on the destination if they match a file which
  203.                     is being copied.
  204.      
  205.           [N]       Calculate a CRC for this file.  This is the same CRC as
  206.                     the CP/M program CRCK returns.
  207.      
  208.           [-N]      Calculate CRC's for all tagged files.
  209.      
  210.           [+N]      Calculate CRC's for all untagged files.
  211.      
  212.           [-O]      Output a list of all tagged files to a disk file.
  213.           [+O]      Output a list of all untagged files to a disk file.
  214.      
  215.           [P]       Protected mass copy option.  Same as "M" option except
  216.                     that the user will be queried before existing files are
  217.                     deleted.
  218.                                      Page 4
  219. .PAè                    CWEEP - A SWEEP-like program for MS-DOS
  220.  
  221.  
  222.           [-Q]      Display a list of tagged files.
  223.      
  224.           [+Q]      Display a list of untagged files.
  225.      
  226.           [R]       Rename the file to something else.  A wildcard new name
  227.                     is allowed.  If just "*" is entered, a wild card may be
  228.                     entered for the old and new names.
  229.      
  230.           [S]       Sort the directory in order by name, extension, date,
  231.                     or size.  Preceed the sort field by "-" to invert the
  232.                     normal order.
  233.      
  234.           [T]       Tag a file.  It will appear in the listing marked with
  235.                     a "*", and will be used in any operations which work on
  236.                     tagged files.
  237.      
  238.           [U]       Untag a file.  Clears the "*" marker.
  239.      
  240.           [V]       Display the file.  It ignores line feeds, and converts
  241.                     returns and vertical tabs to return/linefeed.  This
  242.                     allows listing files created by programs which only put
  243.                     returns in the file, such as Spellbinder.  The listing
  244.                     can be controlled by using return or escape to
  245.                     terminate, and any other key to pause.
  246.      
  247.           [-V]      Display file one 'page' at a time.
  248.      
  249.           [W]       Tag all files matching a wildcard.
  250.      
  251.           [-W]      Tag all files not matching a wildcard.
  252.      
  253.           [Z]       Enter a CHDIR command.  Only valid for MS-DOS versions
  254.                     2.0 and higher.
  255.      
  256.           [?]
  257.           [/]       Print help text for all commands with no "+" or "-"
  258.                     prefix.
  259.      
  260.           [-?]
  261.           [-/]      Print help text for all commands with a "-" prefix.
  262.      
  263.           [+?]
  264.           [+/]      Print help text for all commands with a "+" prefix.
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.                                      Page 5
  273. .PAè                    CWEEP - A SWEEP-like program for MS-DOS
  274.  
  275.  
  276.           [=]       This will take you to a settings menu controlling
  277.                     several program flags.  These are:
  278.      
  279.                     [M]  Turn the menu printing on/off.  Turning it off
  280.                          will suppress printing the menu when logging a new
  281.                          file specification.  Same as the command line
  282.                          option "-?" or "-/".
  283.      
  284.                     [P]  Turn the path display on/off (V2.x only).
  285.      
  286.                     [Z]  Turn ctrl/Z processing on/off.  When on, viewing a
  287.                          file will stop on ctrl/Z.  When off, ctrl/Z is not
  288.                          considered an end of file.
  289.      
  290.                     [=]
  291.                     [Q]
  292.                     [X]  Exit the settings menu and return to normal
  293.                          operations.
  294.      
  295.                     [?]
  296.                     [/]  Print a help message.
  297.      
  298.      
  299.      
  300.                              COMMAND LINE SWITCHES
  301.      
  302.      The following is a list of valid command line switches for CWEEP.
  303.      They may follow or preceed the file specification to be logged in.
  304.      
  305.           [-?]
  306.           [-/]      Toggle the main help menus off.  If present, the main
  307.                     help menus will only be displayed when requested.  This
  308.                     setting may be altered from the mini-menu.
  309.      
  310.           [-p]      Toggle the display of the logged path off.
  311.      
  312.           [-z]      Toggle control/Z processing.  If present on the command
  313.                     line, control/Z will be ignored when encountered in a
  314.                     file being viewed.  This setting may be altered from
  315.                     the mini-menu.
  316.      
  317.           [-d]
  318.           [-e]
  319.           [-n]
  320.           [-s]      Set the initial sort order to ascending whatever.  The
  321.                     options are the same as in the [S] command.  If the
  322.                     switch is entered as [--x] then the order will be
  323.                     descending (i.e., [--d] will sort by descending date,
  324.                     or most recent first).
  325.  
  326.                                      Page 6
  327. .PAè                    CWEEP - A SWEEP-like program for MS-DOS
  328.  
  329.  
  330.         For the user who does not like the default settings of some of the
  331.      command-line switches in CWEEP (not for the faint of heart), it is
  332.      possible to patch the values with DEBUG.  If you unassemble the
  333.      beginning of the code, you will find several move word and move byte
  334.      instructions.  By changing the value moved to 1 (true) or 0 (false)
  335.      the default may be changed (note that sort-order is an ascii
  336.      character).  The move commands are (in order):
  337.      
  338.           1)
  339.                Console on          (Please don't change this!!)
  340.           2)
  341.                Printer off         (Please don't change this!!)
  342.           3)
  343.                Menu on             (The "M" in the settings menu)
  344.           4)
  345.                Initial sort order  (Lower case is ascending)
  346.                                    (Upper case is descending)
  347.           5)
  348.                Ctrl/Z on           (The "Z" in the settings menu)
  349.           6)
  350.                Path display on     (The "P" in the settings menu)
  351.      
  352.      
  353.         CWEEP is written in the C language, and compiled with the C-ware
  354.      DeSmet C compiler.  A Zenith Z-100 was used to develop it.  It has
  355.      been tested by myself or others on a Z-150, IBM PC, and a Wang PC.  It
  356.      uses some custom routines for reading and writing files and handling
  357.      all I/O to the keyboard and printer.
  358.      
  359.         Since CWEEP uses the MS-DOS bdos calls to read/write the keyboard,
  360.      commands such as Ctrl/P and Ctrl/N work for directing output to the
  361.      printer.  This allows the user to obtain a hardcopy listing of a
  362.      session with CWEEP.  I/O redirection in MS-DOS version 2.0 and higher
  363.      allows putting a copy of a session in a file.  However, the output
  364.      would not be displayed on the screen, making it difficult to use.  In
  365.      addition, input redirection may be used if you can figure out exactly
  366.      what the input should be.
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.                                      Page 7
  381.